Unmodified copies of Folder Icon Maker may be distributed at no charge, provided that the distribution includes the standard files listed at the end of this document. Unmodified copies of FIM 1.3 should have a creation and modification date of July 4, 1995, 8:00 PM. Book and disk publishers: please see the note at the end of this document.
Folder Icon Maker creates folders with custom icons. If you haven't already plastered your folders with icons from another program, or even if you have, Folder Icon Maker creates attractive folders from almost any file.
Folder Icon Maker is free, but if you keep it and use it frequently, please send me a picture postcard of your hometown. My mailing address is at the end of this document.
How to use Folder Icon Maker
To use Folder Icon Maker, just drag an application or document onto the FIM icon. A new folder will be created in the same directory as the file is in.
To use a custom folder resource file, just drag it onto FIM. To stop using a custom folder, run FIM and choose Use Standard Folder Icon from the Options menu.
Requirements
System 7 or later; System 7.5 required for some features
Color or greyscale monitor for best results
Features
Ñ Anti-aliases when creating small icons. This improves the visible detail.
Ñ Can create transparent icons. Custom folder icons created from black-and-white icons look better if they are transparent, so the folder shows through.
Ñ Offers full menus in addition to Finder dragging interface.
Ñ Includes balloon help.
Ñ New in version 1.1: Support for custom folder resource files.
Ñ New in version 1.2: Remembers Options menu settings; scriptable and recordable with AppleScript; supports dragging into splash screen window; custom folder resource files can be selected by dragging; under System 7.5, can reliably replace parent folder's icon.
Ñ New in version 1.3: More flexible custom icon support, including dynamic mask generation; under System 7.5, can make folders by dragging any application, document, disk or folder onto FIM; scripts can specify "placing icon on existing item" and "naming new folder".
Drop-launch options
These keys temporarily alter the settings of the items in the Options menu when dragging an item onto Folder Icon Maker's icon.
Ñ To place the folder icon on the clipboard, hold down 'C' while dragging.
Ñ To place the folder icon on a newly created folder, hold down 'N' while dragging.
Ñ To place the folder icon on the parent folder of the file, hold down 'P' or 'F' while dragging.
Ñ To reverse the anti-aliasing setting, hold down 'A' while dragging.
Ñ To reverse the transparency setting, hold down 'T' while dragging. Transparency treats the white portion of the icon as transparent, so the folder shows through.
Scripting Folder Icon Maker
Here's what a typical usage of Folder Icon Maker via AppleScript might look like. If you actually use AppleScript to control FIM, please let me know, since I cannot think of a reason anyone would want to do so.
tell application "Folder Icon Maker"
make icon from alias "Hard Disk:MicroSquish FatsoApp" ┬
using custom folder icon alias "Hard Disk:Folder Icon Maker ─:Green Gradient Folder Resources" ┬
placing icon on new folder ┬
naming new folder "Fatso ─" ┬
with antialiasing and transparent white ┬
without revealing
make icon from alias "Hard Disk:SuperProgram Document" ┬
placing icon on existing item ┬
targeting alias "Hard Disk:OlderFolder:" ┬
with antialiasing, transparent white and revealing
quit
end tell
This is the full scripting dictionary of Folder Icon Maker.
make icon from alias -- The source file for the custom folder icon
[using custom folder icon alias] -- A custom folder icon resource file to use instead of the standard folder icon.
[placing icon on new folder/parent folder/clipboard/existing item] -- Where to put the custom folder icon.
[targeting alias] -- An existing file, folder, or disk to receive the new icon.
[naming new folder string] -- The name for a newly created folder.
[antialiasing boolean] -- Allow anti-aliasing when reducing a large icon.
[transparent white boolean] -- Make white transparent in the custom folder icon.
[revealing boolean] -- Expose and select newly created folder in Finder.
Folder Icon Maker 1.3 has a different application signature than earlier versions have, so scripts written for FIM 1.2 should be recompiled.
Recording AppleScripts with Folder Icon Maker
To record usage of Folder Icon Maker into an AppleScript script, launch FIM, start recording, set the desired menu options in FIM, and then drag applications or documents into the FIM window. Dragging onto the FIM icon in the Finder may not be properly recorded.
Troubleshooting
If you are unable to drag icons onto Folder Icon Maker, try rebuilding your computer's desktop file. To rebuild the desktop, hold down the Command and Option keys when starting up.
System 7.5 users must have the Finder Scripting Extension installed in the Extensions folder for FIM to have full functionality.
Caveats
- Custom icons will not be placed on parent folders considered special by the System, such as the System folder and the Trash.
- FIM cannot usually be used via dragging while FIM is on a floppy. FIM may not work on icons belonging to applications residing on a floppy. Copy the application to a hard drive to use FIM.
- FIM anti-aliasing is ineffective on black-and-white Macintosh models.
- Under Systems 7.0 and 7.1, FIM does not create icons for files displaying generic icons. Under Systems 7.0 and 7.1, FIM does not create icons for folders, disks, and other items which are not applications or documents. However, the tips below explain how to create folder icons for these items.
- Due to limitations of the Finder under Systems 7.0 and 7.1, custom folder icons will be placed on the parent folder only if it has never before had a custom icon. To replace a custom folder icon, create the new icon on the clipboard and paste it over the icon in the folder's Get Info window. This restriction does not apply when using the Scriptable Finder of System 7.5.
Tips
- To remove the icon from a folder, select the folder in the Finder and choose Get Info from the File menu. Next, select the icon in the Info window and choose Clear from the Edit menu.
System 7.0 and 7.1 Tips
- If you use System 7.0 or 7.1 and really want to create a folder icon with a small generic file icon in it, you can do it quite easily. Select the file in the Finder and choose Get Info from the File menu. Next, select the icon in the Info window and choose Copy and then Paste from the Edit menu. Finally, close the Info window and drag the file onto FIM.
- Similarly, under System 7.0 or 7.1 you can create folders icons showing disks and small folders. Open the Get Info window for the disk or the folder, select and copy the icon in the window, and close the window. Next, open the Get Info window for any file, select its icon, choose Paste from the Edit menu, and close the window. The file should now look like the original folder or disk. Drag the file to FIM, and FIM will create the custom folder. To remove the disk or folder icon from the file, open its Get Info window, select the icon in the window, and choose Clear from the Edit menu.
Custom folder icon resource files
- FIM can use a custom folder icon resource file as the background source instead of the generic folder icon. For example, the Gray Floppy Folder Resources file makes floppy icons rather than folder icons (though it still places the floppy icon on a folder in the Finder.)
- There are six resource types for icons: ICN# are large black-and-white icons, ics# are small black and white icons, icl4 and ics4 are large and small 4-bit (16 color) icons, and icl8 and ics8 are large and small 8-bit (256 color) icons. You should duplicate one of the supplied folder icon resource files, and use ResEdit or Resorcerer to edit the icons in the copy.
- Folder icon resource files must have a SHFT resource. The SHFT resource allows you to shift the position of the tiny icon when it is place on the folder icon. Use ResEdit or Resorcerer to change the SHFT. Setting all fields of the SHFT to zero means that the tiny icon should be placed in the standard position (where it would be placed on a normal folder.)
- When editing the SHFT, you must specify how many pixels right and down the small icon is to be shifted when placed on the folder. Negative numbers will shift the icon left or up.
- Shifting of large 1-bit icons right, and small 1-bit icons right and down, is done using the shift numbers provided for 4-bit icons.
- The icon resources in the custom icon file (ICN#, ics#, icl8, ics8, icl4, ics4, icl1, ics1) must have the ID number -3999 to be used.
Note to users of previous versions
Version 1.3 exists because many kind people sent me postcards and feedback on earlier versions. Folder Icon Maker has been my way of giving something to the Macintosh community, and countless people have expressed their appreciation in ways expected and unexpected. If you sent me a card or any other items, I'm sorry that I have been unable to acknowledge it individually, but please accept my thanks and gratitude.
Note to publishers
Publishers of collections of shareware and freeware software on book or disk may include Folder Icon Maker 1.3 if and only if the publisher sends me a copy of the book or disk collection at the address below, and includes in the collection unmodified copies of FIM, this note, and the resource files listed below. Including a version of FIM translated to another language along with the original, unmodified English version is acceptable.
Standard files for Folder Icon Maker 1.3
Standard files included in the Folder Icon Maker 1.3 release are Folder Icon Maker, Folder Icon Maker 1.3 Note, Black Floppy Folder Resources, Executive Folder Resources, Gray Floppy Folder Resources, Gray Gradient Folder Resources, Green Gradient Folder Resources, Shadowed Folder Resources, Tinged Folder Resources, Violet Floppy Folder Resources.
Release history
- December 1991 version 1.0: Initial release.
- May 1992 version 1.1: Fixed bug on 68000 machines, hopefully; added support for custom icon file.
- May 1995 version 1.2: Fixed rare bug involving custom icons on large files (ye shall set ye SetResLoad to false. Say yeah); supports dragging into the application window under System 7.5; can replace parent folder icon under System 7.5; menu settings now remembered; drop-launch keys now toggle the anti-aliasing and transparency options; 'N' key supported when drop-launching for creating a new folder; sends a different message to the Finder under System 7.5 to reveal the created folder icons, avoiding the old "multiple-selected" syndrome; added AppleScript terminology resource (thanks, Jon) and support for a few optional script parameters; sends Apple events to itself to support recording via AppleScript; dropping custom folder resource files onto the application icon or the application window selects the custom folder resource file; fixed dispose of picture resource upon quitting; compiled with CodeWarrior Pascal.
- July 1995 version 1.3: New implementation of folder merging code, removing earlier restriction that the small icon badge be on top of the folder and permitting full shifting of 1-bit and 4-bit icons; accepts AppleScript parameters "placing item on existing item" and "targeting" to replace the icon of an existing folder, file, or disk; accepts AppleScript parameter "naming new folder" for specifying the name given to the folder created by FIM; supports using folders, disks, and generic files as the source items under System 7.5; places new folder icons near source icon under System 7.5; plays a sound when dropping a custom folder resource file onto FIM; puts a picture on clipboard along with icons; new application signature avoids problems with folder and disk dragging.
Your feedback is invited
Comments, criticisms, suggestions are welcome. Please send any feedback to me at
109 Crocker Avenue, Oakland, California 94610 USA
or to grobbins@eworld.com. Picture postcards of your hometown are especially appreciated.
Thanks
to Leonard Rosenthol for providing the shell program upon which FIM is based (a very early version of DropShell; FIM was really just an attempt to test Leonard's code), to Jon Pugh, to Greg Anderson, to my various competitors, to the beta testers for this version (Turadg Aleahmad, Jim Burrows, Jonathan Chapman, Ward Clark, Marshall Clow, Jeffrey Hoover, Taz Hoye, Scott Johnson, Peter Kraneveld, Arnùr Kristjçnsson, Igor Livshits, Andreas Netzer, Joshua Ochs, Patty Yu) and to the numerous users who have given positive and negative feedback (including requests for custom folder icon support, persistent menus, and dynamic mask generation.) Black Floppy Folder Resources, Gray Floppy Folder Resources, Grey Gradient Folder Resources and Tinged Folder Resources by Jonathan Chapman.
